---
title: Hook - Light
description: This Hook blueprint allows to build a controller-based automation to control a light. Supports brightness and color control both for white temperature and rgb lights.
---

import {
  Input,
  Inputs,
  Requirement,
  ImportCard,
  Changelog,
} from '/src/components/blueprints_docs'

<ImportCard id='light' category='hooks' />

<br />

:::tip
This blueprint is part of the **Controllers-Hooks Ecosystem**. You can read more about this topic [here](/docs/controllers-hooks-ecosystem).
:::

## Description

This Hook blueprint allows to build a controller-based automation to control a light. Supports brightness and color control both for white temperature and rgb lights.
:::info
An automation created with this blueprint must be linked to a [Controller](/docs/blueprints/controllers) automation. Controllers are blueprints which allow to easily integrate a wide range of controllers and use them to run a set of actions when interacting with them. They expose an abstract interface used by Hooks to create controller-based automations.

See the list of [Controllers supported by this Hook](#supported-controllers) for additional details.
:::

## Requirements

<Requirement id='controller' required/>
<Requirement name='Light Integration' required>

This integration provides the entity which represents a light in Home Assistant. It should be activated by default so unless you tweaked the default configuration you're good to go.

[Light Integration Docs](https://www.home-assistant.io/integrations/light/)

</Requirement>

## Inputs

<Inputs category='hooks' id='light' />

## Supported Controllers

- [Aqara WXKG11LM Wireless Mini Switch](/docs/blueprints/controllers/xiaomi_wxkg11lm)
- [IKEA E1524/E1810 TRÅDFRI Wireless 5-Button Remote](/docs/blueprints/controllers/ikea_e1524_e1810)
- [IKEA E1743 TRÅDFRI On/Off Switch & Dimmer](/docs/blueprints/controllers/ikea_e1743)
- [IKEA E1744 SYMFONISK Rotary Remote](/docs/blueprints/controllers/ikea_e1744)
- [IKEA E1766 TRÅDFRI Open/Close Remote](/docs/blueprints/controllers/ikea_e1766)
- [IKEA E1812 TRÅDFRI Shortcut button](/docs/blueprints/controllers/ikea_e1812)
- [IKEA E2001/E2002 STYRBAR Remote control](/docs/blueprints/controllers/ikea_e2001_e2002)
- [IKEA E2123 SYMFONISK sound remote, gen 2](/docs/blueprints/controllers/ikea_e2123)
- [IKEA E2201 RODRET Dimmer](/docs/blueprints/controllers/ikea_e2201)
- [IKEA E2213 SOMRIG shortcut button](/docs/blueprints/controllers/ikea_e2213)
- [IKEA ICTC-G-1 TRÅDFRI wireless dimmer](/docs/blueprints/controllers/ikea_ictc_g_1)
- [OSRAM AC025XX00NJ SMART+ Switch Mini](/docs/blueprints/controllers/osram_ac025xx00nj)
- [Philips 324131092621 Hue Dimmer switch](/docs/blueprints/controllers/philips_324131092621)
- [Philips 8718699693985 Hue Smart Button](/docs/blueprints/controllers/philips_8718699693985)
- [Philips 929002398602 Hue Dimmer switch v2](/docs/blueprints/controllers/philips_929002398602)
- [SONOFF SNZB-01 Wireless Switch](/docs/blueprints/controllers/sonoff_snzb01)
- [Tuya ERS-10TZBVK-AA Smart knob](/docs/blueprints/controllers/tuya_ERS-10TZBVK-AA)
- [Xiaomi WXCJKG11LM Aqara Opple 2 button remote](/docs/blueprints/controllers/xiaomi_wxcjkg11lm)
- [Xiaomi WXCJKG12LM Aqara Opple 4 button remote](/docs/blueprints/controllers/xiaomi_wxcjkg12lm)
- [Xiaomi WXCJKG13LM Aqara Opple 6 button remote](/docs/blueprints/controllers/xiaomi_wxcjkg13lm)
- [Xiaomi WXKG01LM Mi Wireless Switch](/docs/blueprints/controllers/xiaomi_wxkg11lm)

## Additional Notes

If you want to link multiple lights to the same controller you can either use [Light Groups](https://www.home-assistant.io/integrations/light.group/) or build multiple Hooks linked to the same Controller.

## Changelog

<Changelog category='hooks' id='light' />
